home *** CD-ROM | disk | FTP | other *** search
/ Programming Languages Suite / ProgramD2.iso / T U R B O Language / Turbo Pascal V7.0 / README < prev    next >
Text File  |  1992-10-30  |  19KB  |  508 lines
  1.                    Welcome to Turbo Pascal 7.0
  2.                    ---------------------------
  3.  
  4. This README file contains important, last minute information
  5. about Turbo Pascal 7.0. In addition to this file, there are
  6. several files in the \TP\DOC directory that you should browse.
  7. See FILELIST.DOC in the \TP directory for a complete list of all
  8. files distributed with this package.
  9.  
  10.  
  11. TABLE OF CONTENTS
  12. -----------------
  13.  1. How to get help
  14.  2. Minimum system requirements
  15.  3. Installation
  16.  4. New features
  17.  5. Release notes
  18.     - Additional documentation
  19.     - Demonstration and utility program notes
  20.     - Compatibility and known problems
  21.  6. Important note for Borland C++ and Paradox 4.0 users
  22.  7. Turbo Pascal and the OS/2 Workplace Shell
  23.  
  24.  
  25. 1. HOW TO GET HELP
  26. ------------------
  27. If you have any problems with this product, please read this
  28. file, the online documentation files in \TP\DOC, the online help
  29. files, and the Turbo Pascal manuals first. If you still have a
  30. question and need assistance, help is available from the
  31. following sources:
  32.  
  33. 1. You can use your modem to easily obtain assistance online.
  34.    Borland maintains support forums on CompuServe, BIX, and
  35.    GEnie. These forums put you in contact with Borland technical
  36.    support engineers and thousands of programmers using Borland
  37.    products. You'll be able get your questions answered and share
  38.    information and ideas with others.
  39.  
  40.    You can also download the latest technical information, sample
  41.    code, utilities, patches, etc., from these online services as
  42.    well as from Borland's Download Bulletin Board Service
  43.    (DLBBS).
  44.  
  45.    Access Borland's online services in the following manner:
  46.  
  47.    CompuServe
  48.      GO BORLAND
  49.  
  50.    BIX
  51.      JOIN BORLAND
  52.  
  53.    GEnie
  54.      BORLAND
  55.  
  56.    Borland DLBBS
  57.      You can reach the Borland DLBBS by dialing (408) 439-9096
  58.      (up to 9600 Baud, 8 data bits, No Parity, 1 Stop bit). No
  59.      special setup is required.
  60.  
  61. 2. TechFax is a toll-free, 24-hour automated service that sends
  62.    free technical information to your fax machine. More than
  63.    1,000 documents discussing Borland software are available
  64.    through TechFax. These documents provide valuable technical
  65.    information that can be used as reference now and in the
  66.    future.
  67.  
  68.    You can call TechFax at 1-800-822-4269 from any touch tone
  69.    telephone and obtain any bulletins or documents that you need.
  70.  
  71. 3. The Technical Support Hot Lines are there to help you with
  72.    questions about installation, system configuration,
  73.    compatibility, and usability. Lines are open from 6:00 A.M.
  74.    to 5:00 P.M. Pacific Time at (408) 461-9177.
  75.  
  76. 4. If you need an advanced level of support, Borland offers
  77.    a new Advisor Lines service where you can get advice on program
  78.    design, debugging, and performance tuning. Advisor Lines
  79.    operate from 8:00 A.M. to 5:00 P.M. Pacific Time at
  80.    1-900-786-6080. Each call is $2.00/minute, with the first
  81.    minute free (available in U.S. only).
  82.  
  83. When calling Borland's Technical Support, please keep your
  84. manuals handy and have the program running. To simplify trouble-
  85. shooting, please be prepared with the following information:
  86.  
  87.   o Product name, serial number, and version number.
  88.  
  89.   o Computer name and model and the name and model of any
  90.     additional hardware (video adapters, modems, etc.).
  91.  
  92.   o Operating system and version number (to find the version
  93.     number, type VER at any DOS prompt). If you are using
  94.     Microsoft Windows, you can find the version number by
  95.     selecting Help|About from Program Manager.
  96.  
  97.   o The contents of your AUTOEXEC.BAT and CONFIG.SYS files
  98.     (located in the root directory (\) of your computer's boot
  99.     disk).
  100.  
  101.   o The contents of your WIN.INI and SYSTEM.INI files located in
  102.     your Windows directory (if you are running Windows).
  103.  
  104.   o A daytime phone number where you can be reached.
  105.  
  106.   o The specific steps necessary to reproduce the problem.
  107.  
  108.  
  109. 2. MINIMUM SYSTEM REQUIREMENTS
  110. ------------------------------
  111. Turbo Pascal 7.0 requires MS-DOS 3.0 or later.
  112.  
  113. TURBO.EXE, the real-mode integrated development environment
  114. (IDE), requires at least 512 Kb of memory.
  115.  
  116. TPX.EXE, the new, high-capacity IDE can use up to 16 Mb of
  117. extended memory and requires the following minimum configuration:
  118.  
  119.   Processor type  :  80286 or later
  120.   DOS memory      :  640k
  121.   Extended memory :  1 Mb available
  122.  
  123. On 80286 machines, it is recommended that you install a memory
  124. manager such as HIMEM.SYS before using TPX. Refer to your DOS
  125. manuals for more information on memory managers.
  126.  
  127. (Please note that TPX requires the files RTM.EXE and DPMI16BI.OVL
  128. to be located on the path or in the same directory as TPX.EXE.)
  129.  
  130. When running TPX.EXE under Windows, make sure to create a Windows
  131. .PIF file and specify a value of 0 in the XMS Memory KB Required
  132. setting and at least a value of 2048 in the XMS Memory KB Limit
  133. setting.
  134.  
  135.  
  136. 3. INSTALLATION
  137. ---------------
  138. IMPORTANT: Turbo Pascal 7.0 is not intended to be installed over
  139. any previous version of Turbo Pascal.
  140.  
  141. Use the INSTALL program to install Turbo Pascal. All files on the
  142. distribution disks are archived and INSTALL will unarchive
  143. them for you. INSTALL places them into subdirectories and
  144. automatically creates configuration files for the command-line
  145. compiler and the two integrated development environments (IDEs).
  146.  
  147. Installation of the full product requires approximately 6 Mb of
  148. available disk space. (The installed product occupies about 4.5
  149. Mb. However, about 1.5 Mb of temporary workspace is required to
  150. unarchive very large ZIP files.) The actual disk space occupied
  151. by this product and the amount of temporary work space required
  152. will vary depending on your disk's cluster size. If you are using
  153. a disk compression utility (e.g., Stacker), you'll need
  154. substantially more temporary workspace to avoid a disk full error.
  155. (The amount you'll need will vary and some systems might require
  156. up to 8 Mb available disk space before running INSTALL.)
  157.  
  158. All further references to directory paths in this README file
  159. assume you've used INSTALL's default directory structure.
  160.  
  161. To start the installation, place the disk labeled INSTALL in
  162. Drive A:, and type A:INSTALL.
  163.  
  164.  
  165. Floppy Disk Installation Notes
  166. ------------------------------
  167. INSTALL's floppy disk installation option will only install the
  168. command-line compiler, TPC.EXE, and the TURBO.TPL library on a
  169. floppy disk.
  170.  
  171. If you want to run the TURBO.EXE integrated development
  172. environment on a floppy-based system, you'll need to unarchive
  173. TURBO.EXE of your choice by hand using the following
  174. instructions.
  175.  
  176. Systems with greater than 360 Kb drives
  177. ---------------------------------------
  178. Place the INSTALLATION DISK in Drive B. Place a blank, formatted
  179. system disk in Drive A. Switch to Drive A and type:
  180.  
  181.   A> copy b:unzip.exe
  182.   A> unzip b:tpl
  183.  
  184. Remove the INSTALLATION DISK from Drive B and place the Turbo
  185. Pascal 7.0 distribution disk containing TURBO.ZIP in Drive B:
  186.  
  187.   A> unzip b:turbo
  188.  
  189. Remove the disk from Drive B. Turbo Pascal 7.0 is now installed
  190. on your system.
  191.  
  192. 360 Kb Systems
  193. --------------
  194. The TFLOPPY.ZIP archive contains a special version of TURBO.EXE
  195. that can be run from a 360 Kb floppy disk. You'll need three
  196. disks in order to install Turbo Pascal 7.0 on your system. First,
  197. create a blank, formatted system disk and label it
  198.  
  199.   Drive A SYSTEM DISK (Source code, TURBO.TPL)
  200.  
  201. Next, create a blank, formatted disk (NOT a system disk) and
  202. label it
  203.  
  204.   Drive B (TURBO.EXE)
  205.  
  206. Finally, create a third blank, formatted disk (NOT a system disk)
  207. for use as a temporary.
  208.  
  209. Now you're ready to begin the installation. Place the Turbo
  210. Pascal 7.0 INSTALLATION DISK in Drive B. Place the Drive A SYSTEM
  211. DISK in Drive A. Switch to Drive A and type:
  212.  
  213.   A> b:unzip b:tpl
  214.  
  215. Remove the disk from Drive A and place the temporary disk in
  216. Drive A. This disk will temporarily contain UNZIP.EXE and the
  217. TFLOPPY.ZIP archive file. Now type:
  218.  
  219.   A> copy b:unzip.exe
  220.  
  221. Remove the INSTALLATION DISK from Drive B and place the Turbo
  222. Pascal 7.0 distribution disk containing TFLOPPY.ZIP in Drive B:
  223.  
  224.   A> copy b:tfloppy.zip
  225.  
  226. Remove the distribution disk from Drive B. Label a third blank,
  227. formatted disk in Drive B (NOT a system disk). Place the Drive B
  228. (TURBO.EXE) disk in Drive B and type:
  229.  
  230.   A> unzip tfloppy b:
  231.  
  232. Remove the temporary disk from Drive A and replace it with the
  233. Drive A SYSTEM DISK. Turbo Pascal 7.0 is now installed on your
  234. system. Always switch to Drive A and type:
  235.  
  236.   A> b:turbo
  237.  
  238. to run Turbo Pascal 7.0 on your system. There is room on the
  239. Drive A SYSTEM DISK to store your .PAS files. Note that this
  240. special version of TURBO.EXE does not support saving startup
  241. options (Options|Environment|Startup).
  242.  
  243.  
  244. 4. NEW FEATURES
  245. ---------------
  246. Turbo Pascal 7.0 offers many new features, including:
  247.  
  248.   o TPX.EXE, a new, high-capacity integrated development
  249.     environment (IDE) that allows you to edit, compile, browse
  250.     symbols, and debug very large applications. TPX can use up to
  251.     16 Mb of extended memory.
  252.  
  253.   o ObjectBrowser - Browse units, objects, and symbols while you
  254.     edit your source code. Includes full cross-reference
  255.     information for every identifier in your program.
  256.  
  257.   o Syntax highlighting - Assign unique text colors for symbols,
  258.     reserved words, identifiers, strings, etc. You can also print
  259.     your syntax-highlighted source code (bold, italics, etc.)
  260.     from inside the IDEs.
  261.  
  262.   o Tools menu in the IDEs that enable you to transfer control to
  263.     external programs, such as GREP or Turbo Assembler. You can
  264.     add your own tools to the Tools menu in the IDEs.
  265.  
  266.   o Persistent symbols - TPX saves your program's symbol
  267.     information across sessions so you can instantly browse or
  268.     debug your program after exiting and then reloading the IDE.
  269.  
  270.   o User-installable Help files in the IDEs. Indexes from
  271.     multiple Help files are automatically merged so you can
  272.     perform keyword or incremental searches.
  273.  
  274.   o Local Menus - A click of the right mouse button (or Alt+F10)
  275.     brings up a context-sensitive menu in both IDEs.
  276.  
  277.   o Optimizations, run-time library, and debugging enhancements
  278.  
  279.     o Now automatically recognizes 386 (or later) processors
  280.       and uses fast 32-bit instructions for longint arithmetic
  281.     o Redundant pointer load suppression
  282.     o Faster text file I/O
  283.     o Faster string Pos routine
  284.     o Optimized sets
  285.     o PChar support - Allows null terminated strings
  286.     o Integer overflow checking {$Q+/-} - Integer, Word, etc
  287.     o OBJ file line number information pass-through - Allows
  288.       stepping through C or ASM code using the integrated
  289.       debugger
  290.  
  291.   o Language extensions
  292.  
  293.     o Open array parameters - Allows safer, more flexible
  294.       variable-length array parameters.
  295.     o New OpenString type - Allows a procedure or function
  296.       to accept any type of string parameter, even in the
  297.       {$V+} state.
  298.     o Constant parameters - Efficient, read-only value
  299.       parameters.
  300.     o Public/private sections - Allows public and private
  301.       sections of objects to be declared in any order.
  302.     o Typed @ operator {$T+/-} - Enforces type-checking when
  303.       using the address (@) operator.
  304.     o Inherited reserved word - Allows references to an inherited
  305.       method without knowing the ancestor's name.
  306.  
  307.   o New standard procedures/functions
  308.  
  309.     o Assigned - Returns True if a pointer is not equal to nil
  310.       (especially useful for procedure and function pointers).
  311.     o Include - Adds an item to a set.
  312.     o Exclude - Removes an item from a set.
  313.     o Break & Continue - FOR, WHILE, REPEAT loop control.
  314.     o Low & High - Return the low or high bounds of open array
  315.       parameters or of any scalar type.
  316.  
  317.   o Turbo Vision enhancements
  318.  
  319.     o Data-validation objects.
  320.     o New outliner object.
  321.     o New methods for inserting/executing windows and dialog
  322.       boxes.
  323.     o Multi-state check boxes.
  324.     o Cluster items that can be disabled.
  325.  
  326.   o Completely reorganized printed documentation with new
  327.     tutorial programs.
  328.  
  329.   o Expanded online Help system covering all the new features.
  330.  
  331. See the "What's new" section of the User's Guide for more
  332. information regarding the new features of Turbo Pascal 7.0.
  333.  
  334.  
  335. 5. RELEASE NOTES
  336. ----------------
  337.  
  338. ADDITIONAL DOCUMENTATION
  339.  
  340.   Changes and corrections to the printed documentation for Turbo
  341.   Vision are in MANUAL.TV in the \TP\DOC directory. Additional
  342.   documentation on TEMC and other utilities can be found in .DOC
  343.   files in the same directory.
  344.  
  345.  
  346. DEMONSTRATION AND UTILITY PROGRAM NOTES
  347.  
  348.   o DOC DEMOS - Source code to all of the examples in the
  349.     documentation can be found in the \TP\EXAMPLES\DOCDEMOS
  350.     subdirectory.
  351.  
  352.   o BGIDEMO SHOWS VESA SUPPORT - See BGIDEMO.PAS in the
  353.     \TP\EXAMPLES\BGI directory for information on how to
  354.     autodetect and use the new VESA16.BGI driver. It supports all
  355.     standard 16-color VESA high resolution modes (800x600,
  356.     1024x768, 1280x1024).
  357.  
  358.   o COMPILING DEMOS - There are new large demonstration programs
  359.     that consist of multiple units each. Make sure you're in the
  360.     directory that contains the demo source code before
  361.     compiling. For example, to build TVFM.PAS, the Turbo Vision
  362.     File Manager demo, change to the \TP\EXAMPLES\TVFM directory
  363.     before doing a compile with either the integrated development
  364.     environment or the command-line compiler.
  365.  
  366.   o SOURCE CODE TO UTILITY PROGRAMS - The integrated development
  367.     environments' new syntax-highlighted printing relies on a
  368.     print filter utility that you can modify. PRNFLTR.PAS can be
  369.     found in the \TP\BIN directory.
  370.  
  371.     For an example of how to write a tool filter for the IDE, see
  372.     GREP2MSG.PAS (the Tool menu's GREP message filter) in the
  373.     same directory.
  374.  
  375.  
  376. COMPATIBILITY & KNOWN PROBLEMS
  377.  
  378.   DOS
  379.   ---
  380.   o TURBO VISION 1.0 SOURCE - The virtual method table (VMT)
  381.     format was modified to support dynamic methods (DMTs). You
  382.     must update any code that relies on fixed offsets into VMTs.
  383.  
  384.     If, for some reason, you want to use Turbo Pascal 7.0 to
  385.     recompile the Turbo Vision source code provided in the Turbo
  386.     Pascal 6.0 Run-time Library Source Code product, change the
  387.     following constant declarations to the values specified
  388.     below:
  389.  
  390.       OBJECTS.PAS:
  391.         TStream_Error = $0C;
  392.         TStream_Flush = $10;
  393.         TStream_Read  = $1C;
  394.         TStream_Write = $28;
  395.         ...
  396.         TCollection_Error    = $0C;
  397.         TCollection_SetLimit = $24;
  398.  
  399.       VIEWS.PAS:
  400.         TView_GetPalette = $30;
  401.  
  402.   TPX (DOS Protected Mode)
  403.   ------------------------
  404.   o OLDER SYSTEM UTILITIES - Some older system utilities and
  405.     application programs (memory managers, disk caches, RAM
  406.     disks, etc.) do not observe current industry standards for
  407.     DOS protected-mode operation. We recommend that you upgrade
  408.     such utilities to more recent versions.
  409.  
  410.   o RUNNING WINDOWS FROM TPX DOS SHELL - Starting Windows in
  411.     enhanced mode from a DOS shell created by TPX is unsafe.
  412.     Normally Windows refuses to load in enhanced mode under such
  413.     conditions, but in certain situations it can hang the system.
  414.     If you do run Windows from a TPX DOS shell, always start
  415.     Windows in Standard mode.
  416.  
  417.   o 386^MAX DPMI SERVER - There are known problems with pre-6.02
  418.     versions of the 386^Max DPMI server. We recommend that you
  419.     obtain and use their latest version (or use the Borland DPMI
  420.     server contained in this package instead).
  421.  
  422.   o COMPAQ VDISK - If you are running on a Compaq 386 with Compaq
  423.     DOS v3.31, you should not use the Compaq VDISK. This version
  424.     of VDISK is not compatible with DOS protected-mode
  425.     applications like TPX.
  426.  
  427.   o OS/2 AND TPX DOS SHELL - If you run TPX under OS/2, push a
  428.     DOS shell and then run another DOS protected-mode
  429.     application, both applications MUST use Borland's
  430.     protected-mode loader.
  431.  
  432.     There is a known problem in OS/2 that will cause the DOS
  433.     session to crash after the second application terminates if
  434.     it uses a different loader. This will be fixed in a future
  435.     release of OS/2's DOS protected-mode support.
  436.  
  437.     Note that it is not safe to start Paradox 4.0 from a TPX DOS
  438.     shell.
  439.  
  440.  
  441. 6. IMPORTANT NOTE FOR BORLAND C++ AND PARADOX 4.0 USERS
  442. -------------------------------------------------------
  443. The DPMILOAD.EXE and DPMI16BI.OVL files provided with this
  444. release replace the older ones that came with Paradox 4.0 and
  445. BC++ 3.0 or later. Delete or rename the older versions and put
  446. \TP\BIN on your DOS path (so Paradox and BC can use the newer
  447. ones).
  448.  
  449. If you want to be able to run BC++ or Paradox from within
  450. TPX.EXE, you will need to use the EXTLEAVE option for the RTM
  451. environment variable in order to leave enough memory available.
  452. For example, you can set aside 2 MB for other programs by using:
  453.  
  454.   SET RTM=EXTLEAVE 2048
  455.  
  456. See the printed documentation for more information regarding the
  457. RTM environment variable.
  458.  
  459. If you plan to shell out from Paradox or BC++ to run TPX.EXE,
  460. limit the amount of extended memory used by those programs. For
  461. Paradox, use its /extk command-line parameter; for BC++, use its
  462. /x command-line parameter. Refer to their documentation for more
  463. information on the use of command-line options.
  464.  
  465. Here's a summary for troubleshooting purposes:
  466.  
  467.   1.  Are there any copies of DPMILOAD.EXE or DPMI16BI.OVL on the
  468.       path prior to those provided in \TP\BIN or in the same
  469.       directories as BC.EXE or PARADOX.EXE? If so, replace them
  470.       with Turbo Pascal 7.0's newer versions, or remove them and
  471.       set your DOS path correctly.
  472.  
  473.   2.  Have you set the RTM environment variable? For example:
  474.  
  475.         SET RTM=EXTLEAVE 2048
  476.  
  477.   3.  If starting Paradox or BC first, have you used the required
  478.       command-line options?
  479.  
  480.  
  481. 7. TURBO PASCAL 7.0 AND THE OS/2 WORKPLACE SHELL
  482. ------------------------------------------------
  483. These are the steps for creating a program icon for TPX.EXE under
  484. the OS/2 2.0 Workplace Shell:
  485.  
  486.   1.  From the OS/2 desktop, double-click the Templates folder
  487.       to open it, grab the Program icon and drop it onto the
  488.       desktop or another folder.
  489.  
  490.   2.  When the Program Settings dialog box appears, enter the
  491.       following:
  492.  
  493.         Path and file Name: *
  494.                 Parameters: /C C:\TP\BIN\TPX.EXE
  495.          Working directory: C:\TP\BIN
  496.  
  497.       Substitute the appropriate drive/path as needed.
  498.  
  499.   3.  Click the Session thumb tab and select DOS full screen
  500.       or DOS window as desired.
  501.  
  502.   4.  Click on the General thumb tab and enter Turbo Pascal 7.0
  503.       for the program title.
  504.  
  505.   5.  Double-click the Close button.
  506.  
  507.                       *    *    *    *    *
  508.